home *** CD-ROM | disk | FTP | other *** search
/ Revista do CD-ROM 100 / CD-ROM 100.iso / aplic / oo1_1 / f_0034 / common.jar / text / common / 02 / 01170202.xml < prev    next >
Encoding:
Extensible Markup Language  |  2003-04-30  |  13.6 KB  |  98 lines
  1. <?xml version="1.0" encoding="utf-8"?>
  2. <html><head><title>Events</title><meta name="filename" content="text/common/02/01170202"/><help:css-file-link xmlns:help="http://openoffice.org/2000/help"/><!--The CSS style header method for setting styles--><style type="text/css">
  3.  
  4.         p.P1{
  5.                 }
  6.         p.P2{
  7.                 }
  8.         p.P3{
  9.                 }
  10.         p.P4{
  11.                 }
  12.         p.P5{
  13.                 }
  14.         p.P6{
  15.                 }
  16.         span.T1{
  17.                 font-weight:bold;}
  18.         </style></head><body>
  19.   
  20.   
  21.   <help:paragraphinfo state="E" xmlns:help="http://openoffice.org/2000/help"/><help:to-be-embedded Eid="ereignisse" xmlns:help="http://openoffice.org/2000/help">
  22.   <p class="Head1"><help:paragraphinfo state="U" number="1"/><help:key-word value="forms; events" tag="kw65913_1"/><help:key-word value="events; forms" tag="kw65913_2"/><help:link Id="65913">Events</help:link></p>
  23.   <p class="Paragraph"><help:paragraphinfo state="U" number="2"/>The<span style="font-weight:bold;"> Events </span>tab page, allows you to assign a macro to certain events which occur in a form.</p>
  24.   <help:paragraphinfo state="E"/></help:to-be-embedded>
  25.   <help:paragraphinfo state="E" xmlns:help="http://openoffice.org/2000/help"/><help:popup Id="65594" Eid="formulareigenschaftenereignisse" xmlns:help="http://openoffice.org/2000/help"><help:embedded Id="65598" Eid="wie"/></help:popup>
  26.   <p class="Paragraph"><help:paragraphinfo state="U" number="35" xmlns:help="http://openoffice.org/2000/help"/>If the form has a subform, the subform also reacts to events in the parent form.</p>
  27.   <p class="Paragraph"><help:paragraphinfo state="U" number="3" xmlns:help="http://openoffice.org/2000/help"/>To link an event with a macro, first write a macro that contains all the commands to be executed when the event happens. Then assign this macro to the respective event by clicking the <span class="T1">... </span><text:s text:c="" xmlns:text="http://openoffice.org/2000/text"/>button beside the corresponding event. The<span class="T1"> Assign Macro </span>dialog opens, where you can select the macro.</p>
  28.   <p class="Paragraph"><help:paragraphinfo state="U" number="29" xmlns:help="http://openoffice.org/2000/help"/>The following actions can be configured individually, meaning that you can use your own dialogs to depict an action:</p>
  29.   <ul class="L1">
  30.    <li class="">
  31.     <p class="P2"><help:paragraphinfo state="U" number="30" xmlns:help="http://openoffice.org/2000/help"/>Displaying an error message,</p>
  32.    </li>
  33.   </ul>
  34.   <ul class="L2">
  35.    <li class="">
  36.     <p class="P3"><help:paragraphinfo state="U" number="31" xmlns:help="http://openoffice.org/2000/help"/>Confirming a delete process (for data records),</p>
  37.    </li>
  38.   </ul>
  39.   <ul class="L3">
  40.    <li class="">
  41.     <p class="P4"><help:paragraphinfo state="U" number="32" xmlns:help="http://openoffice.org/2000/help"/>Querying parameters,</p>
  42.    </li>
  43.   </ul>
  44.   <ul class="L4">
  45.    <li class="">
  46.     <p class="P5"><help:paragraphinfo state="U" number="33" xmlns:help="http://openoffice.org/2000/help"/>Checking input when saving a data record.</p>
  47.    </li>
  48.   </ul>
  49.   <p class="Paragraph"><help:paragraphinfo state="U" number="34" xmlns:help="http://openoffice.org/2000/help"/>For example, you can issue a "confirm deletion" request such as "Really delete customer xyz?" when deleting a data record.</p>
  50.   <p class="Paragraph"><help:paragraphinfo state="U" number="4" xmlns:help="http://openoffice.org/2000/help"/>The following lists and describes all events in a form that can be linked to a macro:</p>
  51.   <help:paragraphinfo state="E" xmlns:help="http://openoffice.org/2000/help"/><help:to-be-embedded Eid="reset_update" xmlns:help="http://openoffice.org/2000/help">
  52.   <p class="Head2"><help:paragraphinfo state="U" number="36"/><help:help-id value="HID_EVT_APPROVERESETTED"/>Prior to reset</p>
  53.   <p class="Paragraph"><help:paragraphinfo state="U" number="51"/><help:help-text value="visible">The<span style="font-weight:bold;"> Prior to reset </span>event occurs before a form is reset.</help:help-text> The linked macro can, for example, prevent this action by returning "FALSE".</p>
  54.   <p class="Paragraph"><help:paragraphinfo state="U" number="52"/>A form is reset if one of the following conditions is met:</p>
  55.   <ul class="L5">
  56.    <li class="">
  57.     <p style=""><help:paragraphinfo state="U" number="53"/>The user presses an (HTML) button that is defined as a reset button.</p>
  58.    </li>
  59.    <li class="">
  60.     <p style=""><help:paragraphinfo state="U" number="54"/>A new and empty record is created in a form that is linked to a data source. For example, in the last record, the <span style="font-weight:bold;">Next Record</span> button may be pressed.</p>
  61.    </li>
  62.   </ul>
  63.   <p class="Head2"><help:paragraphinfo state="U" number="37"/><help:help-id value="HID_EVT_RESETTED"/>After resetting</p>
  64.   <p class="Paragraph"><help:paragraphinfo state="U" number="55"/><help:help-text value="visible">The<span style="font-weight:bold;"> After resetting </span>event occurs after a form has been reset.</help:help-text></p>
  65.   <p class="Head2"><help:paragraphinfo state="U" number="17"/><help:help-id value="HID_EVT_BEFOREUPDATE"/>Before update</p>
  66.   <p class="Paragraph"><help:paragraphinfo state="U" number="56"/><help:help-text value="visible">The<span style="font-weight:bold;"> Before update </span>event occurs before the control content changed by the user is written into the data source.</help:help-text> The linked macro can, for example, prevent this action by returning "FALSE".</p>
  67.   <p class="Head2"><help:paragraphinfo state="U" number="19"/><help:help-id value="HID_EVT_AFTERUPDATE"/>After update</p>
  68.   <p class="Paragraph"><help:paragraphinfo state="U" number="57"/><help:help-text value="visible">The<span style="font-weight:bold;"> After update </span>event occurs after the control content changed by the user has been written into the data source.</help:help-text></p>
  69.   <help:paragraphinfo state="E"/></help:to-be-embedded>
  70.   <p class="Head2"><help:paragraphinfo state="U" number="27" xmlns:help="http://openoffice.org/2000/help"/><help:help-id value="HID_EVT_SUBMITTED" xmlns:help="http://openoffice.org/2000/help"/>Before submitting</p>
  71.   <p class="Paragraph"><help:paragraphinfo state="U" number="28" xmlns:help="http://openoffice.org/2000/help"/><help:help-text value="visible" xmlns:help="http://openoffice.org/2000/help">The<span class="T1"> Before submitting </span>event occurs before the form data is sent.</help:help-text></p>
  72.   <p class="Head2"><help:paragraphinfo state="U" number="5" xmlns:help="http://openoffice.org/2000/help"/><help:help-id value="HID_EVT_LOADED" xmlns:help="http://openoffice.org/2000/help"/>When loading</p>
  73.   <p class="Paragraph"><help:paragraphinfo state="U" number="6" xmlns:help="http://openoffice.org/2000/help"/><help:help-text value="visible" xmlns:help="http://openoffice.org/2000/help">The<span class="T1"> When loading </span>event occurs directly after the form has been loaded.</help:help-text></p>
  74.   <p class="Head2"><help:paragraphinfo state="U" number="38" xmlns:help="http://openoffice.org/2000/help"/><help:help-id value="HID_EVT_RELOADING" xmlns:help="http://openoffice.org/2000/help"/>Before reloading</p>
  75.   <p class="Paragraph"><help:paragraphinfo state="U" number="39" xmlns:help="http://openoffice.org/2000/help"/><help:help-text value="visible" xmlns:help="http://openoffice.org/2000/help">The<span class="T1"> Before reloading </span>event occurs before the form is reloaded.</help:help-text> The data content has not yet been refreshed.</p>
  76.   <p class="Head2"><help:paragraphinfo state="U" number="40" xmlns:help="http://openoffice.org/2000/help"/><help:help-id value="HID_EVT_RELOADED" xmlns:help="http://openoffice.org/2000/help"/>When reloading</p>
  77.   <p class="Paragraph"><help:paragraphinfo state="U" number="41" xmlns:help="http://openoffice.org/2000/help"/><help:help-text value="visible" xmlns:help="http://openoffice.org/2000/help">The<span class="T1"> When reloading </span>event occurs directly after the form has been reloaded.</help:help-text> The data content has already been refreshed.</p>
  78.   <p class="Head2"><help:paragraphinfo state="U" number="42" xmlns:help="http://openoffice.org/2000/help"/><help:help-id value="HID_EVT_UNLOADING" xmlns:help="http://openoffice.org/2000/help"/>Before unloading</p>
  79.   <p class="Paragraph"><help:paragraphinfo state="U" number="43" xmlns:help="http://openoffice.org/2000/help"/><help:help-text value="visible" xmlns:help="http://openoffice.org/2000/help">The<span class="T1"> Before unloading </span>event occurs before the form is unloaded; that is, separated from its data source.</help:help-text></p>
  80.   <p class="Head2"><help:paragraphinfo state="U" number="44" xmlns:help="http://openoffice.org/2000/help"/><help:help-id value="HID_EVT_UNLOADED" xmlns:help="http://openoffice.org/2000/help"/>When unloading</p>
  81.   <p class="Paragraph"><help:paragraphinfo state="U" number="45" xmlns:help="http://openoffice.org/2000/help"/><help:help-text value="visible" xmlns:help="http://openoffice.org/2000/help">The<span class="T1"> When unloading </span>event occurs directly after the form has been unloaded; that is, separated from its data source.</help:help-text></p>
  82.   <p class="Head2"><help:paragraphinfo state="U" number="25" xmlns:help="http://openoffice.org/2000/help"/><help:help-id value="HID_EVT_CONFIRMDELETE" xmlns:help="http://openoffice.org/2000/help"/>Confirm deletion</p>
  83.   <p class="Paragraph"><help:paragraphinfo state="U" number="26" xmlns:help="http://openoffice.org/2000/help"/><help:help-text value="visible" xmlns:help="http://openoffice.org/2000/help">The<span class="T1"> Confirm deletion </span>event occurs as soon as data has been deleted from the form.</help:help-text> For example, the linked macro can request confirmation in a dialog.</p>
  84.   <p class="Head2"><help:paragraphinfo state="U" number="46" xmlns:help="http://openoffice.org/2000/help"/><help:help-id value="HID_EVT_APPROVEROWCHANGE" xmlns:help="http://openoffice.org/2000/help"/>Before record action</p>
  85.   <p class="Paragraph"><help:paragraphinfo state="U" number="58" xmlns:help="http://openoffice.org/2000/help"/><help:help-text value="visible" xmlns:help="http://openoffice.org/2000/help">The<span class="T1"> Before record action </span>event occurs before the current record is changed.</help:help-text> For example, the linked macro can request confirmation in a dialog.</p>
  86.   <p class="Head2"><help:paragraphinfo state="U" number="47" xmlns:help="http://openoffice.org/2000/help"/><help:help-id value="HID_EVT_ROWCHANGE" xmlns:help="http://openoffice.org/2000/help"/>After record action</p>
  87.   <p class="Paragraph"><help:paragraphinfo state="U" number="59" xmlns:help="http://openoffice.org/2000/help"/><help:help-text value="visible" xmlns:help="http://openoffice.org/2000/help">The<span class="T1"> After record action </span>event occurs directly after the current record has been changed.</help:help-text></p>
  88.   <p class="Head2"><help:paragraphinfo state="U" number="48" xmlns:help="http://openoffice.org/2000/help"/><help:help-id value="HID_EVT_POSITIONING" xmlns:help="http://openoffice.org/2000/help"/>Before record change</p>
  89.   <p class="Paragraph"><help:paragraphinfo state="U" number="60" xmlns:help="http://openoffice.org/2000/help"/><help:help-text value="visible" xmlns:help="http://openoffice.org/2000/help">The<span class="T1"> Before record change </span>event occurs before the current record pointer is changed.</help:help-text>. For example, the linked macro can prevent this action by returning "FALSE".</p>
  90.   <p class="Head2"><help:paragraphinfo state="U" number="49" xmlns:help="http://openoffice.org/2000/help"/><help:help-id value="HID_EVT_POSITIONED" xmlns:help="http://openoffice.org/2000/help"/>After record change</p>
  91.   <p class="Paragraph"><help:paragraphinfo state="U" number="61" xmlns:help="http://openoffice.org/2000/help"/><help:help-text value="visible" xmlns:help="http://openoffice.org/2000/help">The<span class="T1"> After record change </span>event occurs directly after the current record pointer has been changed.</help:help-text>.</p>
  92.   <p class="Head2"><help:paragraphinfo state="U" number="50" xmlns:help="http://openoffice.org/2000/help"/><help:help-id value="HID_EVT_APPROVEPARAMETER" xmlns:help="http://openoffice.org/2000/help"/>Fill parameters</p>
  93.   <p class="Paragraph"><help:paragraphinfo state="U" number="62" xmlns:help="http://openoffice.org/2000/help"/><help:help-text value="visible" xmlns:help="http://openoffice.org/2000/help">The<span class="T1"> Fill parameters </span>event occurs when the form to be loaded has parameters that must be filled out.</help:help-text> For example, the data source of the form can be the following SQL command:</p>
  94.   <p class="Paragraph"><help:paragraphinfo state="U" number="63" xmlns:help="http://openoffice.org/2000/help"/>SELECT * FROM address WHERE name=:name</p>
  95.   <p class="Paragraph"><help:paragraphinfo state="U" number="64" xmlns:help="http://openoffice.org/2000/help"/>Here :name is a parameter that must be filled out when loading. The parameter is automatically filled out from the parent form if possible. If the parameter cannot be filled out, this event is called and a linked macro can fill out the parameter.</p>
  96.   <p class="Head2"><help:paragraphinfo state="U" number="9" xmlns:help="http://openoffice.org/2000/help"/><help:help-id value="HID_EVT_ERROROCCURED" xmlns:help="http://openoffice.org/2000/help"/>Error occurred</p>
  97.   <p class="Paragraph"><help:paragraphinfo state="U" number="10" xmlns:help="http://openoffice.org/2000/help"/><help:help-text value="visible" xmlns:help="http://openoffice.org/2000/help">The<span class="T1"> Error occurred </span>event is activated if an error occurs when accessing the data source.</help:help-text> This applies to forms, list boxes and combo boxes.</p>
  98.  </body></html>